Added documentation for GtkWidget::popup_menu.

2004-01-22  Federico Mena Quintero  <federico@ximian.com>

	* gtk/gtkwidget.c (gtk_widget_class_init): Added documentation for
	GtkWidget::popup_menu.

diff --git a/ChangeLog b/ChangeLog
index dd7bf7ffeaa5915b7cb7fc2ee4f0a795b7e42650..c15a547f20e2a44fef6192391a2b2dcf474568ff 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,8 @@
+2004-01-22  Federico Mena Quintero  <federico@ximian.com>
+
+       * gtk/gtkwidget.c (gtk_widget_class_init): Added documentation for
+       GtkWidget::popup_menu.
+
 Thu Jan 22 21:45:24 2004  Matthias Clasen  <maclas@gmx.de>
 
        * gtk/gtkmenu.c (gtk_menu_remove): Remove the attach 

diff --git a/ChangeLog.pre-2-10 b/ChangeLog.pre-2-10
index dd7bf7ffeaa5915b7cb7fc2ee4f0a795b7e42650..c15a547f20e2a44fef6192391a2b2dcf474568ff 100644 (file)
--- a/ChangeLog.pre-2-10
+++ b/ChangeLog.pre-2-10
@@ -1,3 +1,8 @@
+2004-01-22  Federico Mena Quintero  <federico@ximian.com>
+
+       * gtk/gtkwidget.c (gtk_widget_class_init): Added documentation for
+       GtkWidget::popup_menu.
+
 Thu Jan 22 21:45:24 2004  Matthias Clasen  <maclas@gmx.de>
 
        * gtk/gtkmenu.c (gtk_menu_remove): Remove the attach 

diff --git a/ChangeLog.pre-2-4 b/ChangeLog.pre-2-4
index dd7bf7ffeaa5915b7cb7fc2ee4f0a795b7e42650..c15a547f20e2a44fef6192391a2b2dcf474568ff 100644 (file)
--- a/ChangeLog.pre-2-4
+++ b/ChangeLog.pre-2-4
@@ -1,3 +1,8 @@
+2004-01-22  Federico Mena Quintero  <federico@ximian.com>
+
+       * gtk/gtkwidget.c (gtk_widget_class_init): Added documentation for
+       GtkWidget::popup_menu.
+
 Thu Jan 22 21:45:24 2004  Matthias Clasen  <maclas@gmx.de>
 
        * gtk/gtkmenu.c (gtk_menu_remove): Remove the attach 

diff --git a/ChangeLog.pre-2-6 b/ChangeLog.pre-2-6
index dd7bf7ffeaa5915b7cb7fc2ee4f0a795b7e42650..c15a547f20e2a44fef6192391a2b2dcf474568ff 100644 (file)
--- a/ChangeLog.pre-2-6
+++ b/ChangeLog.pre-2-6
@@ -1,3 +1,8 @@
+2004-01-22  Federico Mena Quintero  <federico@ximian.com>
+
+       * gtk/gtkwidget.c (gtk_widget_class_init): Added documentation for
+       GtkWidget::popup_menu.
+
 Thu Jan 22 21:45:24 2004  Matthias Clasen  <maclas@gmx.de>
 
        * gtk/gtkmenu.c (gtk_menu_remove): Remove the attach 

diff --git a/ChangeLog.pre-2-8 b/ChangeLog.pre-2-8
index dd7bf7ffeaa5915b7cb7fc2ee4f0a795b7e42650..c15a547f20e2a44fef6192391a2b2dcf474568ff 100644 (file)
--- a/ChangeLog.pre-2-8
+++ b/ChangeLog.pre-2-8
@@ -1,3 +1,8 @@
+2004-01-22  Federico Mena Quintero  <federico@ximian.com>
+
+       * gtk/gtkwidget.c (gtk_widget_class_init): Added documentation for
+       GtkWidget::popup_menu.
+
 Thu Jan 22 21:45:24 2004  Matthias Clasen  <maclas@gmx.de>
 
        * gtk/gtkmenu.c (gtk_menu_remove): Remove the attach 

diff --git a/gtk/gtkwidget.c b/gtk/gtkwidget.c
index a892d32832851f207442b14c81887c65d49170f7..6e55c679983cccc101ff4f5d419adc17a2c54d80 100644 (file)
--- a/gtk/gtkwidget.c
+++ b/gtk/gtkwidget.c
@@ -1279,6 +1279,18 @@ gtk_widget_class_init (GtkWidgetClass *klass)
                  _gtk_marshal_BOOLEAN__BOXED,
                  G_TYPE_BOOLEAN, 1,
                  GDK_TYPE_EVENT | G_SIGNAL_TYPE_STATIC_SCOPE);
+/**
+ * GtkWidget::popup-menu
+ * @widget: the object which received the signal
+ * @returns: TRUE if a menu was activated
+ *
+ * This signal gets emitted whenever a widget should pop up a context-sensitive
+ * menu.  This usually happens through the standard key binding mechanism; by
+ * pressing a certain key while a widget is focused, the user can cause the
+ * widget to pop up a menu.  For example, the #GtkEntry widget creates a menu
+ * with clipboard commands.  See <xref linkend="checklist-popup-menu"/> for an
+ * example of how to use this signal.
+ */
   widget_signals[POPUP_MENU] =
     g_signal_new ("popup_menu",
                  G_TYPE_FROM_CLASS (gobject_class),